═══ 1. Looking for help? ═══ ZOC is a shareware terminal package. Share it if you use it Good places to start looking for help o Take a look at the Menu Overview o Looking at the Screen Elements can make things a lot easier. o Or just press Ctrl+C to see the contents of this helpfile. ═══ 2. Starting ZOC (command line parameters) ═══ There are some parameters, that can be specified when starting ZOC from the commandline or from an icon. ZOC [/C] [/H:] [/M] [/S:] [/U] [/W:] [COMx] /C This option specifies that you want ZOC to open the com port in shared (cooperative) mode. /H The /H option sets the terminal window to a given height (in characters). /M This option specifies that you want to start ZOC minimized. /U This option specifies unattended mode. In unattended mode ZOC will not show requesters. Instead it uses the default action of these. So ZOC will not hang and wait for an answer if you start it at 3.00AM to automatically collect your messages. /S With this option, you can tell ZOC to process a scriptfile when start. A path can be specified, e. g. 'ZOC /S:SCRIPT\NIGHTCALL' /W The /W option sets the terminal window to a given widht (in characters). COMx This option tells ZOC which com port to use. If not specified, ZOC searches for the ZOCDEVICE environment variable to determine the com port. ═══ 3. Registration information ═══ ZOC is a shareware terminal package. (C) by Markus Schmidt 1994 Read this first Orders, License, Pricing, Payment Registered vs. unregistered version Contacting the author ═══ 3.1. Read this first ═══ This window is not a nuisance feature. It can be turned off via the Window Options dialog. Then just save options as '.\OPTIONS\STANDARD' and you will never see this window again. But: Before turning it off, *PLEASE* read the help topics presented here. Just today I received a three page FAX asking questions, half of which are answered here or in README.DOC (the other window that pops up when you start a new ZOC version). Don't get me wrong: If you don't find the solution to your problem in the docs, you're welcome to contact me. If you encounter problems please check the common problems section first. If you want to register, select Order From from the Help menu. Please read the section about pricing and payment first. If you need a German version it is available from the ZOC support bbs described in availability. You need not play around with the icons of the toolbar. They are described in help for toolbar and you can get a quick description for each icon if you click it with the right mouse button. ═══ 3.2. Contacting the author ═══ I don't monitor international conferences or forums. If you have problems, please contact me personally. Preferred ways to contact me (checked almost daily): Internet M.SCHMIDT@MSN.RMI.DE Please don't post big files (>5K) without my consent. I have to pay for incoming internet mail and I don't want to pay another $450 for internet mail (as in Dec, 1993), if I can avoid it. Zerberus Net M.SCHMIDT@MSN.ZER ZOC Infobbs The number is +49+911+9933662 (or 0911 9933662 from Germany). Login as 'ZOC'. Also possible (checked unregularly): Compuserve 100101,3256 Postal ways: Phone/FAX +49+911+7499380 (or 0911 7499380 from within Germany). This is a hybrid voice/FAX answering machine, that will recognize incoming FAXes (If you encounter problems sending your FAX to this number, try again and if you have no success, send the FAX to +49+911+3193618). Mail Markus Schmidt Waagstr. 4 90762 Fuerth - Germany - ═══ 3.3. Orders, License, Pricing, Payment ═══ Orders The most convenient way to order is to logon to Compuserve, type 'GO SWREG' at the 'forum!' prompt, search for 'ZOC' and register online. This will get you a 'future license' and the price is charged with your next Compuserve bill. If you don't want to order via Compuserve (or if you don't have an account there, select 'Order Form' from the help menu and enter your personal data, method of payment (see below). and type of license. Then print or file the order form. ZOC will compute the price (see below) automatically and print (or file) it with the order form. In return to your order you receive a letter that has a few nice German stamps on it (for your stamp collection) and that contains a license, information on how to remove the display of the order form after each download, a disk label and - if you ordered one - a disk with the current version of ZOC and ZOC related files. License There are two types of license available. Future license With an future license you get a key that entitles you as a single user to use all future versions of ZOC. Version license With a version license you get a key that is valid for a single user to use only those future releases that have the same major version number as the one you register (bug fixes are always treated als minor changes). Pricing ┌────────────┬──────────┬──────────┐ │Version │Outside │Inside │ │ │Germany │Germany │ ├────────────┼──────────┼──────────┤ │Future │$70/DM110 │DM 100 │ │license │ │ │ ├────────────┼──────────┼──────────┤ │Version │$50/DM80 │DM70 │ │license │ │ │ ├────────────┼──────────┼──────────┤ │Version │$40/DM60 │DM50 │ │upgrade │ │ │ ├────────────┼──────────┼──────────┤ │Compuserve │extra $5 │not │ │reg. (*) │ │available │ ├────────────┼──────────┼──────────┤ │Disk │$10/DM15 │DM10 │ ├────────────┼──────────┼──────────┤ │Six pack (#)│-20% │-20% │ ├────────────┼──────────┼──────────┤ │Mass orders │-XX% │-XX% │ │(+) │ │ │ └────────────┴──────────┴──────────┘ Note: Pricing includes everything, no additional payment required. Pricing for Europe/Germany includes 15% VAT/MwSt. (*) since Compuserve charges 15% for the SWREG feature (#) Orders for sixpack discount have to be mailed and paid together. (+) Please contact me to negotiate a price for mass orders (a dozend and more). Payment Credit Cards I accept VISA, MasterCard and Eurocard. Credit cards are charged in DM (see above list). To prevent credit card fraud I need an order form with your written signature (that is, a FAX or a letter) and with your credit card number and expiration date and/or a phone number that I can call back for confirmation of the order. Cash If you send cash, please use registered mail. I will take the additional postage (that is, you pay $5 less for ZOC). Compuserve Compuserve offers a convenient shareware registration feature. To use it you need a Compuserve account. Compuserve registration is only available for future registrations without discount and costs additional $5 since Compuserve charges 15% for the SWREG feature. Check Cashing of foreign checks is possible for me (but costs a few DM). If you order from Germany, send me an Euro- or Verrechnungsscheck. Bank Transfer I guess this is convenient only if used from inside Germany. If you send money via Bank Transfer please send an order form (via mail) as well. My bank is POSTGIROAMT NЪRNBERG (BLZ 760 100 85), account 0314153856. ═══ 3.4. Registered vs. unregistered version ═══ Shareware is not an easy topic. Unfortunately our world is not a perfect one. If it were, it would not be neccessary to restrict (and sometimes cripple) shareware programs. Endless discussions have not found the solution to the question, what fair shareware should be like, because experience shows, that authors of non-restricted shareware tend to die poor and hungry (or at least not rich and well fed). A common way to ensure payment is leaving something important out. So the customer literally pays for what he does not yet have. Many shareware authors play it this way. I do not, because I think that it is wrong. In my opinion the customer has the right to test the full product package before making a decision to buy it or not. I think this is fair, but fairness must apply to both sides. So, be fair too: Register this program if you use it! Early version of ZOC were restricted in ZModem downloads. This was removed due to user requests. Now the only difference between registered and unregistered versions of ZOC is the fact that unregistered versions shows the order form after each download. Please don't try to discuss this with me. I will not remove this and if you call it nagware, maybe you are already using ZOC enough to register anyway. ═══ 4. Other topics (common questions, future versions, ...) ═══ Common problems, questions and answers About this version (known bugs) About future versions Where to get actual versions The meaning of 'ZOC' Contacting the author ═══ 4.1. Common problems, questions and answers ═══ Where do I get the actual version of ZOC? see availability How do I register, what does ZOC cost? see how to order How can I set ZOC to tone dialing Change the modem options and set the dial code to 'ATDT'. ZOC turns NumLock on and off It's not a bug, it's a feature. ZOC uses the NumLock LED for VT100 application key pad. You can turn this off using Options, Emulation. The STANDARD options are not used at startup Maybe you unpacked ZOC without preserving pathnames. The STANDARD file must be in the .\OPTIONS subdirectory. Whenever I leave the program I get a 'carrier detect' warning Maybe your modem is configured to have the CD signal always on. Set it to match the CD state (maybe AT&C1) or set the CD signal to 'invalid' in the serial options. The phone book does not start the script You need to enter the path as well as the script name, eg. SCRIPT\DIALBBS. The phone book does not load the options file You need to enter the path as well as the options file name, eg. OPTIONS\VTOPTS. How can I change the number of rows/colums of the window? see ZOC startup How do I select another com port? see ZOC startup Is there a way to change the font or the colors of the terminal window? You can change the font size (Options,Window), but neither font nor colors. ═══ 4.2. About this version (known bugs) ═══ ZOC is (as you already know) a terminal package. It evolved from an Amiga program that was called AmigaCall (in Germany) or Mindlink (in the U.S.A.). The Amiga sources, which had developed into some sort of swamp, have been redesigned and are now shiny and new and ready for the future. All in all, porting wasn't just a quick hack. ZOC is shareware. It is for evaluation and it is complete. However, there is one (and only one) small nag Known Bugs:none. ═══ 4.3. About future versions ═══ Looking into the future is never easy, so do not take this too literally For future version I plan to implement the following features: 1.x Some smaller changes (nothing revolutionary), bug fixes. 2.x Drag+Drop and WPS support, PM style xdial and quedial, eventually REXX support TO DO The following is a list of features that were already requested by users. It it not clear when I implement them. * bigger toolbar icons * redesign of transfer status window * user defined toolbar * changing of terminal colors * search command for capture * logging of file transfers * translation tables ═══ 4.4. Where to get actual versions ═══ Current versions of ZOC will be available from the following sources. ZOC Infobbs The ZOC information BBS is a simple system (in english) where you can get information, download the actual version of ZOC and leave mail for me. The number is (011)+49+911+9933662 (or 0911 9933662 from Germany). Login as 'ZOC'. Calling Germany is not as expensive as you might expect, download of an actual version of ZOC should cost not more than $3 from the U.S. (calling with 14.400 bps). Compuserve All version with non trivial changes will be available on Compuserve's OS2SHARE forum. Browse for keyword 'ZOC'. Local BBSs/ftp ZOC will make its way around. Check your local bbs or ftp (eg. ftp.cdrom.com) site for files called 'ZOC*.ZIP' ═══ 4.5. The meaning of 'ZOC' ═══ The Hitchhikers Guide to the Galaxy might describe ZOC as followed: zoc (v), to zoc means communicating with other people through the means of extremely sophisticated hard- and software (sophisticated at least from the viewpoint of the ape-descended inhabitants of an extremely unimportant blue planet in an even lesser important part of the galaxy who think that W*****s is a pretty neat piece of software). ═══ 5. Screen Elements ═══ The elements of the screen are the o Actionbar o Toolbar o Main Window o Chat Field o Status line ═══ 5.1. Actionbar (pulldown menus) ═══ The actionbar lets you select functions from the pulldown menu (see Menu Overview). ═══ 5.2. Toolbar ═══ Some of the most commonly used functions can be selected by clicking on the according icon on the toolbar. Modem Phone Book Modem Dial Modem Hangup Capture Browse Capture Clear Capture Print Cliptext Send Cliptext Send without CRs Cliptext Send quoted Transfer Download Transfer Upload Misc Start Script Misc Stop Script Misc Reset Timer Misc Stop Timer Misc Go Timer End Program. Doubleclicking on the space between the buttons will bring up the Window page from the Options Notebook ═══ 5.3. Main Window ═══ The main window displays the received text. You may mark text with the right (block selection) or left (stream selection) mousebutton. The marked text is copied into the clipboard and can be accessed via the functions Cliptext Send, Cliptext Send without CRs, Cliptext Send quoted, Cliptext Print and Cliptext Edit ═══ 5.4. Chat Field ═══ The chat field is an entry field into which you can enter text. The text is not sent until you press enter. This is helpful if you are having an online chat with someone. The chat field can be activated from Window Options or by pressing Alt-C or by pressing the Scroll-Lock key (the least, only if defined accordingly in Terminal Options). If you are in the chat field, it can discard it by pressing ESC or the Scroll-Lock key. Window Options or by pressing Alt-C or by pressing the Scroll-Lock key (the least, only if defined accordingly in Terminal Options). You can use arrow keys to retrieve the last few lines you typed. ═══ 5.5. Status line ═══ The status line contains some buttons with information. Serial Parameters This button displays the currently set line speed and parameters. Clicking on the button brings up the Serial Options dialog. Transfer Protocol This button displays the currently set file transfer protocol. Clicking on the button brings up the Transfer Options dialog. Emulation This button displays the currently set terminal emulation. Clicking on the button brings up the Emulation Options dialog Timer This button displays the timer. The value depends on the currently set mode (see Timer Options). A lowercase letter a-d means that a timer unit is selected and that the timer was stopped. A capital letter indicates that the timer is running. A '1' after the letter indicates daytime charges, a '2' indicates night or weekend charges. A click on the button brings up the Timer Options dialog. LEDs The four LEDs in the status line provide two services: If they are red they display additional status information (LED 1 shows the carrier detect status of the modem, LED 2 shows if you are running a script. LED 3 and 4 emulate the modem receive-data and send-data LEDs, and can be turned off in the window options). If they turn green, your host has requested the Vt100 LED service and sets the LEDs according to the application you run. The LEDs will stay green until you change the emulation or clear the screen from the misc menu. Logfile This checkmark displays the name of the logfile and opens or closes it. Doubleclicking on the space between the buttons will bring up the terminal page from the Options Notebook ═══ 6. Keyboard ═══ Select Keyboard Shortcuts or VT100 Auxiliary Keypad ═══ 6.1. Function Shortcuts ═══ ┌────────────┬────────────────────┐ │Key │Function │ ├────────────┼────────────────────┤ │PgUp │Upload │ ├────────────┼────────────────────┤ │PgDn │Download │ ├────────────┼────────────────────┤ │Shift+Insert│Cliptext Send │ ├────────────┼────────────────────┤ │Ctrl+End │Modem Send Break │ ├────────────┼────────────────────┤ │Alt+B │Capture Browse │ ├────────────┼────────────────────┤ │Alt+C │Show/Hide Chat │ ├────────────┼────────────────────┤ │Alt+D │Modem Phone Book │ ├────────────┼────────────────────┤ │Alt+E │Misc Editor │ ├────────────┼────────────────────┤ │Alt+H │Modem Hangup │ ├────────────┼────────────────────┤ │Alt+L │Capture Open/Close │ ├────────────┼────────────────────┤ │Alt+N │Modem Call Next │ ├────────────┼────────────────────┤ │Alt+Q │Cliptext Send Quoted│ ├────────────┼────────────────────┤ │Alt+R │Modem Redial │ ├────────────┼────────────────────┤ │Alt+S │Options Settings │ ├────────────┼────────────────────┤ │Alt+X │End Program │ ├────────────┼────────────────────┤ │Alt+/ │Misc OS/2 Shell │ ├────────────┼────────────────────┤ │Alt+- │Misc Clear Screen │ └────────────┴────────────────────┘ ═══ 6.2. VT100 Auxiliary Keypad ═══ ┌────────────┬───────────────┐ │VT100 Keypad│IBM Keypad (Num│ │ │Lock Off) │ ├────────────┼───────────────┤ │[PF1] │[F1] │ ├────────────┼───────────────┤ │[PF2] │[F2] │ ├────────────┼───────────────┤ │[PF3] │[F3] │ ├────────────┼───────────────┤ │[PF4] │[F4] │ ├────────────┼───────────────┤ │[0] ... [9] │[0] ... [9] │ ├────────────┼───────────────┤ │[Enter] │[Enter] │ ├────────────┼───────────────┤ │[.] │[./Del] │ ├────────────┼───────────────┤ │[-] │[-] │ ├────────────┼───────────────┤ │[,] │[+] │ └────────────┴───────────────┘ ═══ 7. Menu Overview ═══ Open this branch by pressing the '+' key. or select one of o MODEM o LOGFILE o CAPTURE o CLIPTEXT o TRANSFER o MISC o OPTIONS ═══ 7.1. Modem Menu ═══ The modem menu manages all necessary functions to connect to line. Init This function sends the init string defined in the Modem Options to the modem to reset it. It will do this regardless of the carrier detect state. Dial This function opens a window to enter a phone number. This number is then sent to the modem to be dialled (dial prefix and suffix from Modem Options are used). XDial This function starts a Script If the number is busy, the script tries to connect again for a given number of times. You can edit this script. It is stored in the default script directory under the name SCRIPT\XDIAL. Redial Redials the number dialed last. (dial prefix and suffix from Modem Options are used). Hangup Disconnects the line (the Attn and Hangup strings from Modem Options are used). Send Break Pulls the data pin of the modem low for a given time (see Modem Options). This is called 'break'. Some systems use it to stop the current operation. Phone book Displays a dialog to edit a personal phone book or dial numbers from it. Call next If you selected more than one number to dial from the phone book, this function tries to connect to the next number selected after finishing your first call. This Feature is called queue dialing. Like XDial it is implemented as a Script Call XXXX At the end of the modem menu appear those entries from the phone book that have the quick access option enabled. ═══ 7.2. Logfile Menu ═══ The logfile menu manages all functions necessary to log a session to a file. All incoming data is captured in a memory buffer (capture) and optionally logged to a file (logfile). Name Set the Name of the current logging file. The name can be automatically selected from the phone book when connecting to a bbs. When starting ZOC the logfile gets its name from Capture Options. You may use special placeholders for the name as described in the Capture Options. Default Name Use the default name from Capture Options for the current logging file. Open/Close This function changes the status of capturing to file from open to close or vice versa. This can also be achieved by clicking on the capture name in the status line A closed capture does not log incoming data. ═══ 7.3. Capture Menu ═══ The capture menu manages all functions necessary to log a session in memory to scroll back and review received text. All incoming data is logged in a memory buffer (capture) and eventually in a file (logfile). Browse This function shows the contents of the capture. It can also be accessed from the Toolbar For more information see Browse Window Clear Clears the capture buffer (also availalble from the Toolbar). affected by Safety Options Load Loads a file from disk to the end of the view buffer. Edit Starts the editor from editor definition with the contents of the capture buffer and stores changes back into the capture buffer. Note: This functions closes the browse window if it is open. Print Sends the contents of the view buffer to the printer (also availalble from the Toolbar). ═══ 7.4. Cliptext Menu ═══ Cliptexts are areas of the screen that are marked with the mouse (left or right button) and put into the clipboard after the mousebutton is released. Mark This function is just an info message of how to put text from screen into the clipboard. Send This function takes text from the clipboard and sends it to the modem. It can also be accessed from the Toolbar and is affected by the Ascii Upload Options . Send (no CRs) Takes text from the clipboard and sends it to the modem. Carriage Returns are ignored and a Space is sent instead. The function can also be acccessed from the Toolbar and is affected by the Ascii Upload Options in the Transfer Options window. Imagine the following case: You searched a BBS for files with the keyword TERM and the BBS has given you a list of filenames - one in each line. To download all files, you could mark the list with a box (right mouse button) and send them with a space between them when the BBS asks which file(s) to send. Send quoted Text from the clipboard is sent. Each line is preceeded by '> ' to indicate a quotation. If you press the shift key while selecting this function, ZOC will reformat the text before sending. The function is also available from the Toolbar and is affected by the Ascii Upload Options in the Transfer Options window and 'Quote always smart' in the Window Options window. Edit Calls the system editor (see editor definition) with the contents of the clipboard. After saving, the new contents is written back into the clipboard. Print Sends the contents of the clipboard to the printer. ═══ 7.5. Transfer Menu ═══ The transfer menu allows you to send or receive files. Upload Sends a binary file via modem. The function can also be accessed from the Toolbar and is affected by the Transfer Options window. Download Receives a binary file via modem. The function can also be accessed from the Toolbar and is affected by the Transfer Options window. ASCII Send This functions takes text from a file and sends it to the modem. It is affected by the Ascii Upload Options in the Transfer Options window. Plugs This function gives access to add in modules (so called Plug-In-Protocols) and lets you do Setup, Upload or Download for them. Plug-In-Protocols are provided from third party and are stored in DLL files named PIP*.DLL. If no such modules exist this function is disabled. Transfer Shell Transfer shell launches a command processor from which you can start command line based external protocols that can accept a file handle for the com port. The handle of the communications port is given in the environment variable ZOCHFC. Example: M2ZMODEM -u %ZOCHFC% -r .\DOWNLOADS ═══ 7.6. Miscellaneous Functions ═══ Start Script Starts a script. A script is sort of batch file for ZOC, which helps process specific tasks automatically (see Script). This function can also be acccessed from the Toolbar Stop Script Stops a currently running script. This function can also be accessed from the Toolbar Lock Macros Lock the macro keys to prevent unauthorized use. Unlock Macros Unlock the macro keys again. If defined, the password from Safety Options is required. Reset Timer Reset the timer in the status line which displays the time or cost of your current call. This function can also be accessed from the Toolbar Stop Timer Stop the timer in the status line which displays the time or cost of your current call. This function can also be accessed from the Toolbar Go Timer Restarts the timer in the status line which displays the time or cost of your current call. This function can also be accessed from the Toolbar Set Timer Set the timer to a specific value. Clear Screen This functions just clears the terminal screen and sets the LEDs in the statusline Editor Call the editor defined in the options notebook on the ( Path page). OS/2 Shell Call the shell defined in the options notebook on the ( Path page). ═══ 7.7. Options Menu ═══ The options menu is used to define the characteristics of ZOC. Different sets of characteristics may be saved or loaded for later use. Settings Opens a settings notebook to define all kind of options (see Options Notebook). Jump to Display a submenu (see below) to jump to a specific options dialog. Save Save all of the above options under a special name. If saved under 'STANDARD' they will be loaded automatically when ZOC is started. Load Load a set of options. Reset Reset to the default state. The Jump to menu is a fast way to access the pages of the options notebook directly. Serial Define serial options (e.g. transfer speed and handshake). This function can also be accessed from the Status line Terminal Define terminal and capture characteristics (e.g. local echo, CR translation). Capture Define captrure parameters (e.g. size). This function can also be accessed from the Status line Modem Define modem strings for dialing or hangup. Transfer Define transfer options for file or ascii transfer (e.g. protocol or character delay). This function can also be accessed from the Status line Emulation Define terminal emulations like ANSI, VT100 or TTY. This function can also be accessed from the Status line Timerunits Define time intervals for calculating connect fees. Safety Define when to be prompted for safety or define a password to protect key macros. Path Define default directories for the filerequesters. Macro Keys Define key-macros for later use. These may be password protected (see Safety). Window Define the window font and other display options. ═══ 8. Browse Window ═══ The browse window lets you review the contents of the capture buffer. To control the browse window, use the following keys. ┌────────────┬────────────────────┐ │Key │Function │ ├────────────┼────────────────────┤ │Csr Up │One line up │ ├────────────┼────────────────────┤ │Csr Dn │One line down │ ├────────────┼────────────────────┤ │PgUp │One page up │ ├────────────┼────────────────────┤ │PgDn │One page down │ ├────────────┼────────────────────┤ │Home │Top of buffer │ ├────────────┼────────────────────┤ │End │Bottom of buffer │ └────────────┴────────────────────┘ You may also mark text with the mouse (which is automatically put into the clipboard then). ═══ 9. Help for Options ═══ Open the settings notebook, select a page and clicon on the Help button. ═══ 10. The Options Booklet ═══ This booklet contains all options. Select a tab with the mouse to open the according dialog. Available tabs are: Serial, Terminal, Capture, Modem, Transfer, Emulation, Pathnames, Safety, Macro Keys, Window ═══ 10.1. Serial Options ═══ This window is used to define serial parameters. It can be opened via menu or by clicking on the transfer speed button in the status line. Transfer Speed Select a transfer speed for serial transmission (the transfer speed can also be selected using a script and the BAUD command). Mode Select none, even, odd, mark or space. Databits Select 7 or 8 bits for data transmission. Stopbits Select 1 or 2 stopbits. RTS/CTS handshake If enabled, ZOC uses 7-wire handshake for communication. DSR handshake If enabled, ZOC monitors the DSR signal for communication with the modem. This option should only be enabled if your modem and your cable properly support DSR. Otherwise the com port will hang. XON/XOFF If enabled, ZOC uses the Xon/Xoff software handshake for communication. Auto speed If enabled, ZOC automatically sets the actual transfer speed to the one received when the modem sends a message like 'CONNECT xxxxx'. Valid CD signal If your modem supports the Carrier Detect signal, enable this option. ZOC uses the CD signal to call the functions Stop/Go/Reset Timer in the Misc Menu automatically and eventually writes a calling log to the file defined in Path Options. ═══ 10.2. Terminal Options ═══ This window is used to define terminal parameters. TERMINAL Incoming CR -> CR/LF This options ensures, that each incoming Carriage Return is followed by a Linefeed. Strip high bit If enabled, all characters in the terminal window are printed with 7 bits. Show ctrl chars Shows received control-codes instead of using them (eg. ^I instead of TAB). Destructive backspace This options erases on backspace instead of just spacing back. Local echo Print all characters sent on the console on the terminal window too. Send echo Loop back all incoming characters to the originator. Warning: This may result in an endless loop if the originator also sends an echo (!!!), which is true for most BBS's and hosts. Visual beep Enabling this option turns the beep sound off (a message window is displayed instead). CLIPBOARD SENDING Quote always smart If selected, the Cliptext Send Quoted function will always try to reformat the text before sending it quoted. If this is disabled, text will be reformatted if you select the send-quoted function with the shift key pressed. Width Reformatting will be done in a way that no line is longer than the number of characters specified here. Quick send Selecting this option will send marked text at once if only one line is marked on the screen with the left mouse button. SCROLL LOCK Ignore ZOC ignores the scroll lock state of the keyboard. Chat field Pressing the Scroll Lock key toggles the chat mode (see window options and screen elements). Doorway mode Pressing the Scroll Lock key toggles the keyboard Doorway mode. (Doorway mode is a mode in which special key codes are used. It is required by software like OS2YOU). ═══ 10.3. Capture Options ═══ This window is used to define capture parameters and can be opened via menu or by clicking on the capture size button on the status line. Size Define the size of the capture buffer (in kB's). Default name When you start ZOC, this name will be used as a default name for the logfile. You may use &d, &m, &y, &h, &i as place holders for day, month, year, hour and minute to create dynamic names. The file will be placed in the logging directory set in Path Options Active Save incoming data in the logfile. This is the same as the checkmark in the status line. Append If logging is activated, data is appended to a existing file rather than overwriting it when you start logging. Session headers Session headers are a few lines of information which are inserted into your capture and logging file when connecting to a BBS. Headings are only produced if you have a valid carrier detect signal (see Serial Options). ═══ 10.4. Modem Options ═══ This window is used to define the strings ZOC uses to communicate with your modem. These strings may contain control characters (eg. ^M) and the tilde (~) which is a delay of 1/3 sec. If you deselect the checkbox for 'Initialize when load' the initialisation sequence is used only at startup of program (from the standard options file). If the checkbox is selected, the init string is sent every time a options file is loaded. However, the init sequence is sent only, if ZOC finds no valid carrier detect signal from the modem or if you specify that you want the modem to be initialized even if a carrier signal is detected. If you select the checkbox 'Use DTR for hangup' ZOC pulls the DTR pin of the serial interface low for 0.5 seconds instead of sending the escape and hangup strings. If configured with the AT&D2 command, most modems will hang up on a dropped DTR signal. ═══ 10.5. File Transfer Options ═══ These settings define the characteristics of file transfers. They are accessed via the Options/Settings notebook or by clicking the protocol button on the status line. PROTOCOL Select X- Y- or Zmodem protocol. Zmodem is clearly the best. Some systems falsely also offer the protocols Ymodem and Ymodem batch, which really are Xmodem with Block-1024 for Ymodem and Ymodem for Ymodem-Batch. Time critical Enabling this options boosts ZOC's priority during file transfers, which might help to increase transfer throughput and reduce transfer errors. Note: This will very likely impair the performance of other tasks. XMODEM PARM These options only apply when the Xmodem protocol is selected. CRC on CRC is controlled by the receiver. It selects CRC instead of the less reliable Xmodem checksums. Block 1024 With this option Xmodem uses blocks of 1024 instead of 128 bytes. Some systems falsely call this Ymodem. Chop If enabled, ZOC tries to remove padding bytes when receiving a file. ASCII-UPLOAD These options are used for ASCII-Uploads and sending of the clipboard contents. CR -> CR/LF Ensures that each Carriage Return is followed by a Linefeed. Char-Delay ZOC waits n milliseconds, before sending each character. Fourth this time is used for each end of line. ZMODEM OPTIONS Auto transfer If enabled, ZOC starts Zmodem transfers automatically. Start taps A tap is an add-in function for download. If enabled, ZOC checks if you have a tap for the currently downloaded file extension (eg. a GIF-Viewer) and starts it. The name of a tap is TAP_XXX.EXE where XXX is the extension of the files for which the tap should be used. IF FILE EXISTS Select what you want to do if you try to download a file that already exists on your disk. ═══ 10.6. Emulation Options ═══ This window is used to set the emulation. It can be opened via menu or by clicking on the emulation button in the status line. Swap keys If you enable the keys swap option, a Backspace is sent when the DEL key is pressed and vice versa. This is helpful for many VT100 systems. Discard codes Screen control for ANSI and VT100 is done by sending special control codes. Logging of these control codes in the capture may be disabled. Disable VT100 key pad In VT100 mode the numeric key pad is used as the VT100 auxiliary keypad (see VT100-keyboard). This might be problematic on machines without an numeric keypad (eg. Laptops) and can be disabled. Note: If you need the auxiliary keypad for a VT100 system, press Shift+Ctrl and a key from the keypad (use '+' for VT100-',' and use 'Del' for VT100-'.'). If you need VT100-PF1/2/3/4 press Ctrl+Shift+F1/2/3/4 instead. ═══ 10.7. Timer and Timerunit Options ═══ Phone units are used to monitor telephone charges, if charges are based on time intervals. Currently this function might be useful only in Germany. In Germany phone call are charged based on time intervals (called phone units) with a fixed cost but variable length. The longer the distance of the call, the shorter the time interval. There are three distance zones (local/med/long) and there is a distinction between day and night/weekend calls. Units You may define up to four time intervals (in seconds and for day and night) and the cost for one interval. Show timer as Elapsed time The status line shows time elapsed since resetting the timer. Money This option shows the time elapsed since resetting the timer as a money value. Fraction This option shows how many units were used. Clock The time of day is displayed. Warning If this field is any other value than zero (eg. '80'), ZOC signals at this specified point in time (eg. 80%) to give you the opportunity to cut the connection before another time interval begins, thus saving you from paying for more units than necessary. ═══ 10.8. Safety Options ═══ Define if you want to be warned before attempting some "dangerous" operations. Ask 'are you sure' This should be self explanatory. Warning if high speed ... The RTS/CTS handshaking method provides reliable control of the data flow between the PC and the modem. If you use high transfer speeds without RTS/CTS handshake you will verly likely encounter transmission errors. Enabling this option gives you a warning if you select more than 2400 baud without selecting RTS/CTS as well. Save options ... Here you can select if you want to save options automatically when you leave the program. If this option is deselected potential changes are discarded at the end of program. Lock Macro Keys If you leave your computer unattended for a while, you can lock the macro keys to prevent unauthorized use. To unlock them, the password will be asked for. Locking can also be initiated from the Misc Menu. Password If a password is specified, the dialogs for Phone book Definition, Keymacro Unlocking and macro key definition will ask for it, because all passwords for accessing online services are stored in these dialogs. CAUTION: The password is case sensitive and there is no backdoor if you forget it. ═══ 10.9. Definition of Default Pathnames ═══ The pathnames defined here are the default directories for file requesters or special functions. The 'QWK Dl.' field defines a directory into which downloaded files with names like *.QW? are stored. This is helpful with the popular fido offline news readers (eg. Kurt Westerfield's excellent KWQ product). Editor defines the editor to be used when calling the Cliptext Edit function from the Cliptext menu, or when calling the Edit function from the Misc menu. Shell defines a shell to be opened, when calling the OS/2 Shell function in the Misc menu. If a logfile is defined, ZOC logs all calls (time, duration, cost) to it. ═══ 10.10. Window Property Definition ═══ Font size Select a font size for the terminal window from the list. Selection of other fonts is not possible. Screen size Defining the screen size in the options booklet is not yet possible. Right now you have to specify the screen size via command line parameters. SCREEN ELEMENTS Initial Help Here you can turn off the initial help display. Toolbar Here you can turn off the toolbar. Status line Here you can turn off the status line. Chat field Here you can turn off the chat field (see screen elements). The chat field can be turned on and off with the Scroll-Lock key if you defined this in terminal options. Disable RD/SD ... Here you can turn off the (maybe annoying) two LEDs in the statusline that emulate the modem receive-data and send-data LEDs. Jump to top if carrier detect If set, the main window of ZOC will come to the top of the desktop if the modem carrier detect signal is switched on. Jump scroll Jump scrolling speeds up scrolling for screen output with fast modems. It looks a bit skippy and is not of much help with slower modems. Big cursor Enabling this option makes the cursor in the main window a bit bigger. ═══ 10.11. Macro Key Definition ═══ Select strings to be sent when F4-F12 or Shift F1-F12 is pressed. Use the caret to define control codes (like ^M for ). You can map a script onto a function key if you define the key like '^$=' (eg. '^$=SCRIPT\MY_SCRIPT') ═══ 11. Phone book ═══ Select How to use the phone book or Changing a phone book entry. ═══ 11.1. How to use the phone book ═══ Just like in a real phone book, names and numbers are stored here. It is subdivided into four sections (default, 1st, 2nd and 3rd alternate) which means, that you practically have four different phone books. Each entry in a phone book can be defined to simply dial a number once, dial a number repeatedly until you get a connection or execute a Script. If you select more than one entry, ZOC will create a file called DIALQUE as a to-do list and start the QUEDIAL script to connect to the first available BBS from that list. After leaving the BBS, you can process the rest of the list with the Call Next function from the modem menu. Note: When QUEDIAL connects to a BBS it deletes all entries from the to-do list that are equal to the connected BBS in the first six characters. This way you can connect to a multi line BBS (eg. Avalon-1, Avalon-2 ...). If one line is free the others will not be called again. Dial Execute the operation (Dial, XDial, Script) for the selected entry. Delete Delete selected entry from phone book. Edit Change the data of the selected entry (see changing a phone book entry). New Create a new entry to this phone book. Clone Create and edit a copy of the selected entry. Default Switch to the default phone book. Book#1 Switch to the 1st alternate phone book. Book#2 Switch to the 2nd alternate phone book. Book#3 Switch to the 3rd alternate phone book. ═══ 11.2. Changing a phone book entry ═══ Name A name for the entry. For multi port BBSs use names that are equal in the first six characters (eg. AVALON-1, AVALON-2 ...). This way the queue dial feature will not try to connect to all of the ports, but only to one. Quick access Select this if you want the BBS to be accessible from the modem menu. Insert a tilde before a character in the name (eg. 'ZOC ~Infobbs'), to create a shortcut for the menu. Serial parameters Serial parameters to be set before calling the number (eg. 19200-8N1). If you leave this field blank, the actual setting or the setting from a loaded options file will be used. You may leave out the options (and just type a line speed). If you just want to set the options and leave the actual line speed unchanged set the speed to zero (eg. 0-7N1). Option file Option file to be loaded before setting the serial parameters and dialling the number. The option file must be preceded by a path (eg. OPTIONS\COMPUSRV.OPT). Logfile Name to be used for logging the session. Special placeholders can be used as described in Capture Options. Phone/Script A phone number or the name of a scriptfile (the script file must be preceded by a path eg. SCRIPT\CALL_ZOC). Emulation Select emulatoin to switch to before calling the bbs. Type of action Select if the string in the phone/script field is a number to dial once, a number to dial repeatedly until connection is established or if it is the name of a script to be executed. A script receives the Name, and Autologin fields in the lastline variable and may use them for own purposes (that it could define new keywords for the autologin field). Phone book Select the phone book to store this entry to. Zone Select the distance zone for the BBS (see Options Units). Day/Night/Weekend is selected automatically. Autologin If you select XDial as the type of value (see below), this field is a sequence of keywords (separated by bars '|') that control the redial and login process. S0=... If defined, S0 is sent unconditionally after carrier detect. Wn/Sn=... Define pairs of words to wait for and to reply then. Text to wait for is defined as W1, W2 ..., the corresponding text to be send is defined as S1, S2 .... INIT=... Optional init string to send to the modem before trying to connect to the bbs WAIT=... Optional time in seconds to wait between unsuccessful attempts (XDIAL only). Note Keywords must not be lowercase letters Example INIT=ATZ1^m|WAIT=30|W1=Name|S1=Zaphod^M|W2=Password|S2=HeartOfGold^M ═══ 12. Help for File Transfer ═══ File Transfer lets you send or receive binary files. Uploading is sending, download means for receiving a file. See Options Transfer for more information. Note: The speed indicator for Z-Modem reflects the transfer speed of the last block, not the average speed from the beginning of the transfer. Total average speed is shown at the end of the transfer. Information: If you use an unregistered version (see Registration), the order form will be displayed after each download. ═══ 13. Script Language Commands ═══ This is a short reference of all available script commands. For more information about variables and common commands review the samples in the SCRIPT\SAMPLES directory. Check the program part at the end of the list as a prerequisite for the some of the examples. ADD Add a number to a variable. Example: ADD VARN 11; WRITELN %VARN% => 110 ASK []Read text from user. Result in %lastline%. Example: ASK "Are You sure?" BAUD [-{7|8}{N|O|E}{1|2}]Set serial parameters. Example: BAUD 4800-8N1 BEEP []Beep n times CALL